home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-2.iso / Files II / Newton / Programming / ArrayEditor.sit / AEditor-VtHick protos Readme / AEditor-VtHick protos Readme
Encoding:
Text File  |  1994-04-18  |  4.7 KB  |  118 lines  |  [TEXT/R*ch]
  1. These user prototypes (protoArrayEditorVtHick, protoLabelEditPickerVtHick and
  2. protoLabelEditInputLine) are Shareware. Any programmer using these protos in
  3. their programs must send 2 times the cost of their program or $795 which ever
  4. is lower to Hardy Macia, 1413 Surrey Lane, Wynnewood PA 19096. This means
  5. that authors of Freeware can use these protos for free and authors of
  6. commercial programs might possibly pay as much as $795 for the use of these
  7. protos. Shareware authors need not pay until they have received more 10
  8. shareware fees. Postcardware authors need only send me one postcard. This 
  9. license is on a per package basis so if you create 1 commercial package and
  10. one freeware package and one shareware package using my prototypes These
  11. prices can be negotiated with the Hardy Macia. 
  12.  
  13. I can also be reached at:
  14.  
  15.  HardyMacia@eWorld.com          <-not work-> (610) 649-2487
  16.  macia@sinbad.navsses.navy.mil   <-work->    (215) 897-8545
  17.  
  18. protoArrayEditorVtHick, protoLabelEditPickerVtHick and
  19. protoLabelEditInputLine are copyrighted ©1994 by
  20. and all rights are reserved by Hardy Macia.
  21.  
  22. protoArrayEditorVtHick - interface between program and user for modifying of 
  23.                          arrays.
  24.  
  25.     confirmChange    Optional. Default True. Will ask for confirmation after
  26.                     user press Change button because Changing items is most
  27.                     likely undoable.
  28.     Setup            Required. Must be called after the :Open message is
  29.                     sent to protoArrayEditVtHick. The parameters are
  30.                         targetView - specifies the view to which arrayEditor
  31.                                      messages are sent
  32.                          arrayLabel - label for the kind of array - this
  33.                                       is prepended to title.
  34.                          theArray   - the array to be modified. (This array 
  35.                                       is not mangled)
  36.     title            Optional. The title of the array editor window.
  37.  
  38.     ArrayEditorChanged  Required Script of targetView as specified in the
  39.                         Setup() method.
  40.                         
  41.                         See description in protoLabelEditInputLine.
  42.     
  43.     ArrayEditorCounter    Required Script of targetView as specified in the
  44.                         Setup() method.
  45.                         
  46.                         See description in protoLabelEditInputLine.
  47.                                                       
  48.  
  49.  
  50.  
  51.  
  52.  
  53. protoLabelEditInputLine - a protoInputLabelLine with the added feature of
  54.                         the user being able to edit the labelCommands. This
  55.                         proto requires protoArrayEditorVtHick to work. 
  56.                         protoArrayEditorVtHick must be declared as
  57.                         arrayEditorVtHick in the a parent view.
  58.     
  59.     labelCommands -        Optional. You might want to give the user a few
  60.                         starting items.
  61.     
  62.     ArrayEditorChanged  This script must handle the changing of the data from
  63.                         oldItem to newItem for actions of type 'Change. For
  64.                         actions of type 'Remove and 'Add nothing should be
  65.                         required, but you never know.
  66.                         Parameters:
  67.                             action - symbol ('Change, 'Remove, or 'Add) the
  68.                                      action the user performed to the array.
  69.                             newArray - the new array
  70.                             oldItem - item changed, item removed, or item
  71.                                       added
  72.                             newItem - item changed to or nil
  73.                             status - static text view to display status of 
  74.                                      change
  75.     
  76.     ArrayEditorCounter    Required Script. passed array item that needs to be
  77.                         counted. This function should return the number of
  78.                         entries equal to item. Zero should be returned if no
  79.                         entries where found. The symbol 'itemsExist can be
  80.                         returned if items are found but you do not want to
  81.                         waste time counting every item.
  82.  
  83. protoLabelEditPickerVtHick - a protoLabelPicker with the added feature of
  84.                         the user being able to edit the labelCommands. This
  85.                         proto requires protoArrayEditorVtHick to work. 
  86.                         protoArrayEditorVtHick must be declared as
  87.                         arrayEditorVtHick in the a parent view.
  88.     
  89.     label -             To make my protos a little more consistent. I added 
  90.                         label. Label is what needs to be set for the label,
  91.                         NOT the text as with Apple's protoLabelPicker.
  92.     
  93.     labelCommands -        Optional. You might want to give the user a few
  94.                         starting items.
  95.     
  96.     ArrayEditorChanged  This script must handle the changing of the data from
  97.                         oldItem to newItem for actions of type 'Change. For
  98.                         actions of type 'Remove and 'Add nothing should be
  99.                         required, but you never know.
  100.                         Parameters:
  101.                             action - symbol ('Change, 'Remove, or 'Add) the
  102.                                      action the user performed to the array.
  103.                             newArray - the new array
  104.                             oldItem - item changed, item removed, or item
  105.                                       added
  106.                             newItem - item changed to or nil
  107.                             status - static text view to display status of 
  108.                                      change
  109.     
  110.     ArrayEditorCounter    Required Script. passed array item that needs to be
  111.                         counted. This function should return the number of
  112.                         entries equal to item. Zero should be returned if no
  113.                         entries where found. The symbol 'itemsExist can be
  114.                         returned if items are found but you do not want to
  115.                         waste time counting every item.
  116.  
  117.  
  118.